/*
  Name: linklist.h
  Copyright: 
  Author: 
  Date: 21-03-05 20:21
  Description: 
*/

#ifndef LINKLIST_H_INCLUDED
#define LINKLIST_H_INCLUDED

#include "ds.h" //for Status,OK ...

#ifndef ElemType
#define ElemType int /* 数据元素类型默认为 int */
#define ELEMTYPE_TAG
#endif

/**********************************************************
*  单链表的存储结构定义 
***********************************************************/
typedef struct LNode {
    ElemType data;
    struct LNode *next;
} LNode, *LinkList;


/**********************************************************
*  单链表的基本操作声明
***********************************************************/

//创建并初始化为空表 
Status InitList(LinkList &L);

//销毁整个表(从此之后不再可用) 
Status DestroyList(LinkList &L);

//将表L置空 
Status ClearList(LinkList &L);

//判断表L是否为空表 
bool ListEmpty(LinkList L);

//求表L的长度 
int ListLength(LinkList L);

//取表L中的第i个元素,并用e返回. 操作成功返回OK,失败时返回ERROR 
Status GetElem(LinkList L, int i, ElemType &e);

//在表L中定位元素e首次出现的位置. 操作成功返回位序,失败时返回0 
//    compare(a,b) 为比较函数,匹配时返回true,否则返回false 
//                 这里默认使用equal进行比较 
int LocateElem(LinkList L, ElemType e, 
      bool (*compare)(ElemType,ElemType));

//在表L中插入第i个元素e. 操作成功返回OK,失败时返回ERROR
Status ListInsert(LinkList &L, int i, ElemType e);

//删除表L中第i个元素,结果用e返回. 操作成功返回OK,失败时返回ERROR 
Status ListDelete(LinkList &L, int i, ElemType &e);

//遍历表L,对每个元素调用visit(x). 
Status ListTraverse(LinkList L, Status (*visit)(ElemType));
 

/**********************************************************
*  单链表的基本操作的实现
***********************************************************/

//创建并初始化为空表 
Status InitList(LinkList &L)
{
    // TODO (#1#): 创建空表
    return ERROR;
    //-------------------------------------
}

//销毁整个表(从此之后不再可用) 
Status DestroyList(LinkList &L)
{
    // TODO (#1#): 销毁表 
    return ERROR;
    //-------------------------------------
}

//将表L置空 
Status ClearList(LinkList &L)
{
    // TODO (#1#): 清空表
    return ERROR;
    //-------------------------------------
}

//判断表L是否为空表 
bool ListEmpty(LinkList L)
{
    // TODO (#1#): 链表判空 
    return false;
    //-------------------------------------
}

//求表L的长度 
int ListLength(LinkList L)
{
    // TODO (#1#): 链表求长度
    return 0;
    //-------------------------------------
}

//取表L中的第i个元素,并用e返回. 操作成功返回OK,失败时返回ERROR 
Status GetElem(LinkList L, int i, ElemType &e)
{
    // TODO (#1#): 实现取元素GetElem(L,i,&e)
    return ERROR; 
    //-------------------------------------
}

//在表L中定位元素e首次出现的位置. 操作成功返回位序,失败时返回0 
//    compare(a,b) 为比较函数,匹配时返回true,否则返回false 
int LocateElem(LinkList L, ElemType e, bool (*compare)(ElemType,ElemType))
{
    // TODO (#1#): 在表中定位元素e,用compare(a,b)匹配元素
//    LinkList p;
//    int j;
//    
//    p = L->next; j = 1;
//    while(p!=NULL) {
//        if( compare(p->data,e) )  return j;
//        p=p->next;
//    }
    return 0;
    //-------------------------------------
}


//在表L中插入第i个元素e. 操作成功返回OK,失败时返回ERROR
Status ListInsert(LinkList &L, int i, ElemType e)
{
    // TODO (#1#): 在链表中插入元素
    return ERROR;
    //-------------------------------------
}

//删除表L中第i个元素,结果用e返回. 操作成功返回OK,失败时返回ERROR 
Status ListDelete(LinkList &L, int i, ElemType &e)
{
    // TODO (#1#): 在链表中删除元素
    return ERROR;
    //-------------------------------------
}

//遍历表L,对每个元素调用visit(x). 
Status ListTraverse(LinkList L, Status (*visit)(ElemType))
{
    LinkList p = L->next;
    while ( p ) {
        if ( visit(p->data)==ERROR )  return ERROR;
        p = p->next;
    }
    return OK;
}


#ifdef ELEMTYPE_TAG
#undef ElemType
#undef ELEMTYPE_TAG
#endif

#endif  // LINKLIST_H_INCLUDED
